Obtains a handle to a picture stored in a 'PICT' resource.

PicHandle GetPicture (
    SInt16 pictureID
);

pictureID

The resource ID for a 'PICT' resource.

function result

A handle to the picture in the specified ëPICT’ resource. To draw the picture stored in the resource, pass this handle to the DrawPicture function. If the resource cannot be read, GetPicture returns NULL.

DISCUSSION

The GetPicture function calls the Resource Manager function GetResource as follows:

GetResource(ëPICT’, picID)

SPECIAL CONSIDERATIONS

To release the memory occupied by a picture stored in a 'PICT' resource, use the Resource Manager function ReleaseResource.

The GetPicture function may move or purge memory.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)